home *** CD-ROM | disk | FTP | other *** search
/ SPACE 1 / SPACE - Library 1 - Volume 1.iso / utilitys / 457 / sentinel.txt < prev   
Text File  |  1990-07-07  |  4KB  |  100 lines
  1. **************************************
  2. *                                    *
  3. *  Write Error Sentinel              *
  4. *  by John Eidsvoog                  *
  5. *  Copyright 1990 CodeHead Software  *
  6. *                                    *
  7. **************************************
  8.  
  9. Release date: Friday, March 2, 1990
  10.  
  11.  
  12. What it is
  13. ----------
  14.  
  15. Write Error Sentinel is a memory-resident program which monitors disk
  16. writing and will inform you with an alert box if there is a write error. 
  17. There are a few instances and two in particular where there is no
  18. warning given when you run out of free disk space. 
  19.  
  20. One particular danger is with ARC602.TTP which will not inform you if
  21. you run out of room.  It's easy to delete an ARC file before you
  22. realize you haven't extracted its files correctly.
  23.  
  24. Another case is when saving a capture file with a Flash! .DO file.  A
  25. message appears on the bottom line but is immediately overwritten by the
  26. next command in the .DO file.  With the Sentinel installed, you'll get
  27. an alert box making sure you've seen the message. 
  28.  
  29. Considering that Write Error Sentinel uses less than 1K of your memory,
  30. it is a valuable addition to your AUTO folder.
  31.  
  32.  
  33. How to set it up
  34. ----------------
  35.  
  36. Simply copy SENTINEL.PRG into your AUTO folder.  It must run after
  37. FATSPEED.PRG or POOLFIX3.PRG if you are using either of these. 
  38. Otherwise it can be anywhere in your AUTO folder.  You'll see a small
  39. message when Sentinel installs.  You can also install (run) SENTINEL.PRG
  40. from the desktop.  That's it...once installed, it just sits and watches. 
  41.  
  42.  
  43. How it works
  44. ------------
  45.  
  46. Write Error Sentinel watches for GEMDOS Fwrite calls.  GEMDOS returns
  47. from the call, reporting the number of bytes that were written.  If this
  48. number doesn't match the number of bytes requested to be written, the
  49. Sentinel reports it to you with an alert box stating:
  50.  
  51.                ------------------------------------
  52.               |  ____   THE SENTINEL REPORTS:      |
  53.               | /    \  An error has occured while |
  54.               | |STOP|  writing to this disk.      |
  55.               | \____/  The disk may be full.      |
  56.               |                                    |
  57.               |                ----                |
  58.               |               | OK |               |
  59.               |                ----                |
  60.                ------------------------------------
  61.  
  62. You should realize that many or most times this happens you will get two
  63. error messages; one from the Sentinel, and one from the program doing
  64. the writing.  Luckily, this does not happen very often.  Most disk
  65. errors are detected at the file creating and opening level and the
  66. Sentinel will ignore these.  The main type of error caught by the
  67. Sentinel is insufficient disk space. 
  68.  
  69. For me it is well worth a few extra error messages if it will save me
  70. some of the aggravation I've had when I wasn't warned at all. 
  71.  
  72.  
  73. POINTS TO NOTE:
  74. ---------------
  75.  
  76. Remember that the Sentinel reports whenever the number of bytes requested
  77. to be written doesn't match the number actually written.  It doesn't
  78. necessarily mean that the disk is full, but if there is an attempt to
  79. write more bytes than a disk has free, the Sentinel will always report.
  80.  
  81. In some programs (such as ARC602.TTP) you may get Sentinel's alert box
  82. with no mouse arrow to click OK.  Just hit Return or Enter (or play the
  83. game of searching with the mouse button held down :-).
  84.  
  85.  
  86. Copyright stuff
  87. ---------------
  88.  
  89. SENTINEL.PRG, and this document are Copyright 1990 CodeHead Software. 
  90. However, they may be freely distributed as long as this text file and
  91. the Write Error Sentinel program file are both included.  Neither this
  92. document file (SENTINEL.TXT) or the program file (SENTINEL.PRG) may be
  93. altered in any way.  Copies of these files may not be sold, and this
  94. document may not be reprinted, without the express written permission of
  95. CodeHead Software. 
  96.  
  97. We've tried to make Write Error Sentinel as bug-free as possible. 
  98. Nevertheless, CodeHead Software cannot be responsible for any damages
  99. that may occur as a result of the use (or misuse) of Write Error Sentinel. 
  100.